Chapitre 1 Présentation générale d’un projet PROPRE

1.1 Qu’est-ce qu’un projet collaboratif PROPRE ?

Un projet collaboratif PROPRE est un projet qui suit le “PROcessus de Publications REproductibles” et qui est conduit par une équipe pluri-disciplinaire. Suite à la réponse de la DREAL Pays de la Loire à un appel à projet du Commissariat Général au Développement Durable (CGDD) fin 2015 sur le thème de la connaissance stratégique des territoires, un centre de service de la donnée a été constitué en 2018. Le “DREAL datalab” doit proposer des accès facilités aux données brutes, agrégées et analysées produites et les diffuser.
Afin de favoriser la réussite des projets, des méthodes modernes de développement et l’utilisation d’outils libres et open-source ont été testées. La production de données et d’analyses de ces données requièrent aujourd’hui leur présentation dans un cadre reproductible pour au moins trois raisons : la confiance en l’information, sa fraîcheur et le gain de temps à en produire des nouvelles. Ainsi s’est présentée la nécessité définir un PRocessus pour monter des projets collaboratifs de Publications REproductibles et donc diffusables. L’acronyme PROPRE est né.
La mise en place de ce processus ne pouvait se réaliser que dans une seule équipe. Une équipe pluri-disciplinaire d’agents de différentes DREAL s’est constituée pour mettre le processus à l’épreuve des besoins et contraintes de chacun sur un projet collaboratif commun.

Les détails de la genèse et les concepts du processus se trouvent dans le livre numérique : C’est du PROPRE !

1.2 Un projet PROPRE est multi-compétences

Un projet PROPRE nécessite différents rôles de coordination, édition, programmation et communication. En effet, l’objectif d’un projet PROPRE est la publication d’une analyse de données, de préférence diffusée de manière numérique. Son contenu mélange des traitements de données, du texte explicatif, de l’analyse des résultats, de l’expertise terrain qui nécessitent l’implication de plusieurs personnes, de compétences complémentaires, à différents niveaux du processus.
Le côté reproductible de cette publication doit la rendre ré-utilisable d’une année sur l’autre lors de la mise à jour des données, ou paramétrable pour être déclinée sur une zone géographique en particulier.

Notez que PROPRE a initialement été mis en place pour publier des documents de type livres numériques ou page web. Cependant, toutes les méthodes de mise en place et de suivi de projet collaboratif sont adaptables à tous types de projets R, que ce soit la production de documents statiques, interactifs ou d’applications Shiny. Il est en effet recommandé que le contenu de tout projet R soit créé de manière reproductible.

1.3 Le premier projet PROPRE : {propre.rpls}

Un premier projet inter-DREAL a permi de mettre en oeuvre le processus : le projet {propre.rpls}. Son but est de faciliter la production de publications régionales et nationales sur le parc locatif social à partir de la source RPLS (répertoire des logements locatifs des bailleurs sociaux) renouvelée chaque année. Il contient un template de livre numérique paramétrable par échelle d’observation (région ou France entière) et les fonctions nécessaires à la création des illustrations.

1.4 Que contient le présent livre numérique ?

Ce livre s’adresse aux différentes personnes impliquées dans un processus de développement PROPRE. Nous distinguerons trois catégories de contenu :

  • [01 - coordination] : Comment mettre en place un tel projet, quels sont les rôles à répartir, quels sont les moyens et les outils nécessaires, … ?
  • [02 - édition] : Comment définir ses besoins, comment présenter le contenu des documents, comment collaborer avec l’équipe de développement, … ?
  • [03 - développement] : Comment lancer techniquement le projet, quels outils utiliser, quelles méthode de développement avec R, quelles sont les bonnes pratiques, … ?

Le présent document a été créé avec R et Markdown grâce un “PROcessus de Publications REproductibles” (PROPRE), documenté, testé, versionné avec une forge logicielle adaptée

1.5 Comment citer ce livre ?

Pour citer le livre, vous pouvez ajouter dans un de vos fichiers *.bib :

@Book{guide_publication_propre,
  title = {Organisation d’un projet collaboratif de publication PROPRE},
  author = {Sébastien Rochette, Ph},
  year = {2022},
  url = {https://rdes_dreal.gitlab.io/publication_guide/production/},
}